home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / utility / pl4019ax.zip / README.DOS < prev    next >
Text File  |  1992-01-26  |  3KB  |  85 lines
  1. Notes on BC++ (VROOM) port of Perl 4.019
  2. ----------------------------------------
  3.  
  4. Perl Library:
  5.  
  6.     Copy all the .pl files to "c:/usr/local/lib/perl"; this is the
  7.     directory plumbed into @INC where Perl will look for packages
  8.     and/or the debugger.
  9.  
  10.  
  11. Globbing:
  12.  
  13.     Globbing is performed by perlglob.exe; both it and perl.exe
  14.     should be copied to a directory somewhere in your DOS PATH.
  15.     perlglob.exe will be found whenever it is needed - just make
  16.     sure its in your PATH.
  17.  
  18.     By default globbing is done in lower case; if you prefer upper
  19.     case or want the option to switch between them use the PERLGLOB
  20.     environment variable.  It works as follows:
  21.  
  22.         set PERLGLOB=U
  23.         set PERLGLOB=u                - Glob in Upper case
  24.  
  25.         set PERLGLOB=<anything else you like>
  26.         or
  27.         no environment variable called PERLGLOB - Glob in lower case
  28.  
  29.  
  30. Temporary files:
  31.  
  32.     Placement of temporary files is controlled through the TMP
  33.     environment variable.  Files will be placed in the current
  34.     directory if there's no such variable in the environment.
  35.     
  36.     Temporary files are deleted after use.
  37.  
  38.  
  39. Additional Perl subroutines:
  40.  
  41.     Two DOS specific user subroutines have been added via the
  42.     usersub.c hook.
  43.  
  44.     &stkfree()    - Returns the size of unused stack space.
  45.     &heapfree()    - Returns the size of free space in the far heap.
  46.  
  47.  
  48. Swapping:
  49.  
  50.     When you invoke other programs from Perl (via system() or similar)
  51.     this version of Perl will attempt to swap itself out of memory
  52.     either to extended memory or disk (in that order).  Swap files
  53.     are created in the current working directory and are NOT 
  54.     influenced by the setting of the TMP environment variable.
  55.  
  56.     There is a restriction of the type of program that you can run from
  57.     Perl with this implementation.  Any program that leaves part of
  58.     itself resident before returning to DOS (such as print.com or
  59.     some shells) will cause Perl to fail with an error message of
  60.     "XSPAWN error".  xspawn() is the routine used to run programs
  61.     from Perl; it requires that all memory used by the program run
  62.     is freed before return to DOS (and hence to xspawn).
  63.  
  64.     This is the price for getting 605K in which to run programs
  65.     from Perl rather than about 200K if this method wasnt used.
  66.  
  67.  
  68. Bugs:
  69.  
  70.     This version of Perl has passed all the test scripts except those
  71.     that depend on UNIX or that re-invoke Perl from within the
  72.     script (not enough memory !).
  73.  
  74.     If you find something that works on a UNIX version of Perl 4.019
  75.     and *doesn't* work on this version then I'd really like to hear
  76.     about it (complete with the script that caused the problem so
  77.     I can troubleshoot the bug).  If the problem can be reproduced
  78.     on the UNIX version then post a note to comp.lang.perl or
  79.     send a note to Larry (lwall@netlabs.com).  If you mail Larry
  80.     remember that he probably gets more mail than you could imagine
  81.     in your wildest nightmares..... so try to make *very* sure that
  82.     you have a real bug.  DOS specific problems on this port should
  83.     be mailed to me (stu@tandem.com).
  84.  
  85.